Release 10.1A: OpenEdge Development:
Web Services

bprowsdldoc

Runs the WSDL Analyzer, which provides HTML documentation on the interface that a Web Service Description Language (WSDL) describes. This HTML documentation describes how a Progress 4GL programmer can access the Web service and its operations in the 4GL.

Syntax

Operating system	Syntax
UNIX Windows	bprowsdldoc     [ -h ]   |     {        [ -b | -nohostverify | -nosessionreuse          | -WSDLUserid username  | -WSDLPassword password          | -proxyhost host       | -proxyport port          | -proxyUserid username | -proxyPassword password          | -show100style        ] ...        wsdl-url-or-filename [ target-directory ]     }

-h

Displays a help message on the usage of this command.

-b

Forces documentation of binding names. A Web service can offer two options for a Web service client to connect (or bind) to it (see Chapter 9 "Connecting to Web Services from the Progress 4GL"):

Using services with ports (most common).
Using binding names (the names of the WSDL <binding> elements) with SOAP endpoints that you must obtain separately (sometimes used to bind a SOAP viewer).

Normally, if a WSDL defines services, the Analyzer includes only the service and port names in the generated documentation. If the WSDL does not define any services, the Analyzer documents the binding names. This option tells the Analyzer to document the binding names even when services are defined in the WSDL.

-nohostverify

Turns off host verification for a Secure Socket Layer (SSL) connection using HTTPS.

-nosessionreuse

Prevents any reuse of the SSL session ID for an HTTPS Web server connection when reconnecting the same Web server using HTTPS.

-WSDLUserid username

Specifies a username for accessing the WSDL file.

-WSDLPassword password

Specifies a password for accessing the WSDL file.

-proxyhost host

Specifies the name or IP address of the host where an HTTP-based proxy server required to access the WSDL file is located.

-proxyport port

Specifies the port on which the HTTP-based proxy server is listening for requests to download WSDL files.

-proxyUserid username

Specifies a username for accessing an HTTP-based proxy server.

-proxyPassword password

Specifies a password for accessing an HTTP-based proxy server.

-show100style

Shows procedure and function signatures as documented in the 10.0x releases of OpenEdge. With the release of 10.1A, some procedure signatures are changed for ease of use. For more information, see the sections on analyzing wrapped document literal in Chapter 8, " Analyzing WSDL for Progress 4GL Access to Web Services.".

wsdl-url-or-filename

Specifies a URL, Microsoft Uniform Naming Convention (UNC), or local pathname to the WSDL file. If the string does not specify a URL protocol ("file://", "http://", or "https://") or start with a UNC prefix ("\\"), it is assumed to be a a local file pathname.

target-directory

Specifies the target directory (to be created if necessary) where the Analyzer will write the generated documents. If not specified, the Analyzer assumes the current working directory. Choose a directory dedicated for the specified WSDL file, as some generated document filenames are the same for multiple WSDL files.

For more information on the documentation output from the WSDL Analyzer, see Chapter 8, " Analyzing WSDL for Progress 4GL Access to Web Services."